package com.wgh.product.service;

import com.wgh.product.entity.shop.Brand;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

/**
 * 品牌Service接口
 * 
 * @author AI Shop
 */
public interface BrandService extends IService<Brand> {

    /**
     * 获取启用的品牌列表
     * 
     * @return 启用的品牌列表
     */
    List<Brand> getEnabledBrands();

    /**
     * 根据品牌名称查询品牌
     * 
     * @param name 品牌名称
     * @return 品牌信息
     */
    Brand getBrandByName(String name);

    /**
     * 根据品牌首字母查询品牌
     * 
     * @param firstLetter 品牌首字母
     * @return 品牌列表
     */
    List<Brand> getBrandsByFirstLetter(String firstLetter);

    /**
     * 批量更新品牌状态
     * 
     * @param ids 品牌ID列表
     * @param status 状态
     * @return 是否成功
     */
    boolean updateStatusBatch(List<Long> ids, Integer status);

    /**
     * 查询品牌关联的商品数量
     * 
     * @param brandId 品牌ID
     * @return 商品数量
     */
    int countProductsByBrandId(Long brandId);

    /**
     * 搜索品牌
     * 
     * @param keyword 搜索关键词
     * @return 品牌列表
     */
    List<Brand> searchBrands(String keyword);

    /**
     * 分页查询品牌
     * 
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 品牌列表
     */
    List<Brand> getBrandPage(Integer pageNum, Integer pageSize);
}